home *** CD-ROM | disk | FTP | other *** search
/ Aminet 31 / Aminet 31 (1999)(Schatztruhe)[!][Jun 1999].iso / Aminet / dev / c / vbccm68k.readme < prev    next >
Text File  |  1999-05-02  |  13KB  |  301 lines
  1. Short:    Free optimizing ANSI C compiler (68k)
  2. Author:   volker@vb.franken.de (Volker Barthelmann)
  3. Uploader: volker@vb.franken.de (Volker Barthelmann)
  4. Version:  0.7
  5. Type:     dev/c
  6. Replaces: dev/c/vbcc.lha,dev/c/vbcc_ppc.lha
  7.  
  8. vbcc - portable ANSI C compiler (c) in 1995-99 by Volker Barthelmann
  9.  
  10.  
  11. INTRODUCTION
  12.  
  13.     vbcc is a free portable and retargetable ANSI C compiler.
  14.  
  15.     This archive contains the compiler, preprocessor, assembler, linker,
  16.     frontend, message browser, startup codes, C-libraries, amiga.lib
  17.     replacements as well as several other tools for 68k.
  18.  
  19.     This gives you a complete system that allows to develop programs in
  20.     ANSI C as well as Amiga-specific programs (provided you obtain the
  21.     OS-includes) running on 68k.
  22.  
  23.     All major parts of this distribution (including compiler, preprocessor,
  24.     libraries etc.) have been compiled/assembled with this system and
  25.     apart from the OS-includes everything needed to rebuilt vbcc,
  26.     the libraries and many of the other programs is contained in this
  27.     archive and the corresponding source archive.
  28.  
  29.     Note that the programs in this archive all run on the 68k. There is
  30.     another archive which contains compilers that run on the PPC.
  31.  
  32.  
  33. FEATURES
  34.  
  35.     vbcc..
  36.  
  37.     - comes with source
  38.  
  39.     - is free
  40.  
  41.     - is portable and retargetable
  42.  
  43.     - comes with a global optimizer that can e.g. do global common
  44.       subexpression elimination, constant propagation, function inlining
  45.       and several other optimizations (but is not yet finished and may
  46.       have some bugs)
  47.  
  48.     - should be ANSI compliant
  49.  
  50.     - can generate code that runs on a plain 68000 CPU
  51.  
  52.     - can generate code optimized for 020/030, 040 or 060
  53.  
  54.     - can generate code that uses the 68881/2, 68040/060 FPUs directly
  55.       and comes with appropriate math-libraries
  56.  
  57.     - can generate code that runs on PowerUp-boards
  58.  
  59.     - generates standard Amiga-68k-objects, PPC-ELF-objects or
  60.       WarpOS-EHF-objects
  61.  
  62.     - does not need too much memory
  63.  
  64.     - comes with a message browser
  65.  
  66.     - comes with a config program
  67.  
  68.     - offers a lot of error/warning messages that can be turned on/off
  69.       separately
  70.  
  71.  
  72. WHAT'S NEW
  73.  
  74.     Some changes since the last release:
  75.  
  76.     - bug fixes
  77.  
  78.     - new optimizations
  79.  
  80.     - much improved libaries
  81.  
  82.     - use of Frank Wille's linker vlink
  83.  
  84.     - support for PPC/WarpOS
  85.  
  86.     - support for small data for PPC/ELF and PPC/WarpOS
  87.  
  88.     - support for __saveds (68k, PPC/ELF and PPC/WarpOS)
  89.  
  90.     - support for __far (68k, PPC/EFL and PPC/WarpOS)
  91.  
  92.     - support for __chip (68k and PPC/WarpOS)
  93.  
  94.     - support for auto opening of libraries (68k, PPC/ELF and PPC/WarpOS)
  95.  
  96.     - cleaned up distributions for all three Amiga targets
  97.  
  98.     - checking for unresolved symbols for PPC/ELF
  99.  
  100.     - scheduler for PPC (ELF and WarpOS)
  101.  
  102.  
  103. REQUIREMENTS
  104.  
  105.     To use vbcc you need:
  106.  
  107.     - an Amiga with OS 2.0 or higher
  108.  
  109.     - enough RAM (it is possible to translate small programs with 1MB, but
  110.       for larger programs much more will be needed)
  111.  
  112.     Stuff that is not needed, but may be very useful:
  113.  
  114.     - harddisk
  115.  
  116.     - editor
  117.  
  118.     - make, touch etc.
  119.  
  120.     - the Amiga OS-includes (they can be found on certain CDs)
  121.  
  122.     - pipe-command (to use the message browser)
  123.  
  124.     Also you should know how to use the shell and you should know ANSI C
  125.     (if you need a book I recommend (like everyone) "The C Programming
  126.     Language, Second Edition, ANSI C" by Kernighan and Ritchie).
  127.  
  128.  
  129.  
  130. Volker Barthelmann                                      volker@vb.franken.de
  131.  
  132.  
  133. ============================= Archive contents =============================
  134.  
  135. Original  Packed Ratio    Date     Time    Name
  136. -------- ------- ----- --------- --------  -------------
  137.   320284  136384 57.4% 07-Mar-99 20:17:04 +vbccm68k
  138.    14072    8221 41.5% 07-Mar-99 20:17:04 +vc
  139.    36588   19935 45.5% 07-Mar-99 20:17:04 +vcpp
  140.    69232   34224 50.5% 07-Mar-99 20:17:04 +vlink
  141.    12828    7057 44.9% 07-Mar-99 20:16:44 +vprof
  142.     6303    2409 61.7% 07-Mar-99 20:16:48 +building.doc
  143.    30554    8605 71.8% 07-Mar-99 20:16:48 +errors.doc
  144.    50461   17891 64.5% 07-Mar-99 20:16:48 +History
  145.    28898   10203 64.6% 07-Mar-99 20:16:48 +interface.doc
  146.    25948    8655 66.6% 07-Mar-99 20:16:48 +vbcc.doc
  147.    10374    4276 58.7% 07-Mar-99 20:16:48 +vbcc.faq
  148.     4428    1836 58.5% 07-Mar-99 20:16:48 +vbccalpha.doc
  149.     3331    1428 57.1% 07-Mar-99 20:16:48 +vbccc16x.doc
  150.     4736    1955 58.7% 07-Mar-99 20:16:48 +vbcci386.doc
  151.    13535    5016 62.9% 07-Mar-99 20:16:50 +vbccm68k.doc
  152.     7518    2824 62.4% 07-Mar-99 20:16:50 +vbccppc.doc
  153.     7075    2752 61.1% 07-Mar-99 20:16:50 +vc.doc
  154.     3007    1483 50.6% 07-Mar-99 20:16:50 +vcpp.doc
  155.     8035    2916 63.7% 07-Mar-99 20:17:12 +vlink.doc
  156.      771     409 46.9% 07-Mar-99 20:16:50 +vprof.doc
  157.     1803     916 49.1% 07-Mar-99 20:16:50 +vsc.doc
  158.    10180    5973 41.3% 07-Mar-99 20:17:06 +alib
  159.    29900   14982 49.8% 07-Mar-99 20:17:06 +fd2lib
  160.     9280    5562 40.0% 07-Mar-99 20:16:44 +genauto
  161.     1352     885 34.5% 07-Mar-99 20:17:06 +ixstacksize
  162.    65396   41716 36.2% 07-Mar-99 20:17:08 +PhxAss
  163.      536     378 29.4% 07-Mar-99 20:16:44 +showerr
  164.      568     402 29.2% 07-Mar-99 20:16:44 +tovbr
  165.    13320    6791 49.0% 07-Mar-99 20:16:44 +vbrowse
  166.    25412   10696 57.9% 07-Mar-99 20:16:44 +vconfig
  167.     1576     883 43.9% 07-Mar-99 20:16:44 +vsend
  168.     4888    2266 53.6% 07-Mar-99 20:16:52 +alib.doc
  169.     1308     675 48.3% 07-Mar-99 20:16:46 +autolib.doc
  170.     2561    1081 57.7% 07-Mar-99 20:16:52 +extralib68k.doc
  171.     5946    2623 55.8% 07-Mar-99 20:16:52 +fd2lib.doc
  172.     3440    1439 58.1% 07-Mar-99 20:16:52 +ixemul.doc
  173.     1755     872 50.3% 07-Mar-99 20:16:52 +minstart.doc
  174.   138364   47484 65.6% 07-Mar-99 20:16:52 +PhxAss.guide
  175.    72511   14238 80.3% 07-Mar-99 20:16:46 +VBCCMessages.guide
  176.     7967    3071 61.4% 07-Mar-99 20:16:52 +vclib68k.doc
  177.      502     288 42.6% 07-Mar-99 20:16:46 +vconfig.doc
  178.        0       0  0.0% 07-Mar-99 20:16:44 +
  179.      594     201 66.1% 07-Mar-99 20:16:44 +init_vbcc
  180.      540     241 55.3% 07-Mar-99 20:17:06 +ixemul
  181.      548     244 55.4% 07-Mar-99 20:17:06 +ixemuls
  182.      546     239 56.2% 07-Mar-99 20:17:06 +vc.config
  183.      276     215 22.1% 07-Mar-99 20:16:46 +vbr.arexx
  184.    49024   19549 60.1% 07-Mar-99 20:16:46 +vpm
  185.    11189    4722 57.7% 07-Mar-99 20:16:46 +vpm.guide
  186.      281     185 34.1% 07-Mar-99 20:16:54 +assert.h
  187.     1089     340 68.7% 07-Mar-99 20:16:54 +ctype.h
  188.     2285     708 69.0% 07-Mar-99 20:16:54 +errno.h
  189.      910     288 68.3% 07-Mar-99 20:16:54 +extra.h
  190.     1028     313 69.5% 07-Mar-99 20:16:54 +float.h
  191.     3257     618 81.0% 07-Mar-99 20:16:58 +amigaguide_protos.h
  192.      980     273 72.1% 07-Mar-99 20:16:58 +asl_protos.h
  193.      390     156 60.0% 07-Mar-99 20:16:58 +battclock_protos.h
  194.      711     226 68.2% 07-Mar-99 20:16:58 +battmem_protos.h
  195.      879     236 73.1% 07-Mar-99 20:16:58 +bullet_protos.h
  196.     2904     627 78.4% 07-Mar-99 20:16:58 +cardres_protos.h
  197.      265     170 35.8% 07-Mar-99 20:16:58 +cia_protos.h
  198.      429     169 60.6% 07-Mar-99 20:16:58 +colorwheel_protos.h
  199.     3937     800 79.6% 07-Mar-99 20:16:58 +commodities_protos.h
  200.      497     230 53.7% 07-Mar-99 20:16:58 +console_protos.h
  201.     3087     633 79.4% 07-Mar-99 20:16:58 +datatypes_protos.h
  202.      787     245 68.8% 07-Mar-99 20:16:58 +disk_protos.h
  203.      807     296 63.3% 07-Mar-99 20:16:58 +diskfont_protos.h
  204.    25518    4257 83.3% 07-Mar-99 20:17:00 +dos_protos.h
  205.      112      94 16.0% 07-Mar-99 20:16:58 +dtclass_protos.h
  206.    18575    3045 83.6% 07-Mar-99 20:17:00 +exec_protos.h
  207.     4030     738 81.6% 07-Mar-99 20:16:58 +expansion_protos.h
  208.     3916     795 79.6% 07-Mar-99 20:16:58 +gadtools_protos.h
  209.    32915    5167 84.3% 07-Mar-99 20:16:58 +graphics_protos.h
  210.     1862     439 76.4% 07-Mar-99 20:16:58 +icon_protos.h
  211.     8113    1206 85.1% 07-Mar-99 20:16:58 +iffparse_protos.h
  212.      112      96 14.2% 07-Mar-99 20:16:58 +input_protos.h
  213.    25040    3868 84.5% 07-Mar-99 20:16:58 +intuition_protos.h
  214.      814     280 65.6% 07-Mar-99 20:17:00 +keymap_protos.h
  215.     5534     893 83.8% 07-Mar-99 20:16:58 +layers_protos.h
  216.     4879     804 83.5% 07-Mar-99 20:17:00 +locale_protos.h
  217.     2431     581 76.1% 07-Mar-99 20:17:00 +lowlevel_protos.h
  218.      358     169 52.7% 07-Mar-99 20:1